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OCTAL DEBUGGING PROGRAM (ODT-80) 

PART IV-LLL BASIC 



By E. R. Fisher 



FOREWARD 



This article is the last part of a series of 
four articles covering the LLL 8080 BASIC In- 
terpreter program released to the public domain 
by Lawrence Livermore Laboratories. This month 
we shall cover the description of the Octal De- 
bugging Program ODT-80 and include the complete 
assembly listing of the ODT-80 program. 

INTRODUCTION 

ODT-80 is an octal debugging routine for use 
on the Intel 8080 microprocessor. This routine 
provides the capability to examine and modify 
all of the memory that is available to the micro- 
computer and transfer program control to the 
created program. ODT-80 makes use of simple 
keyboard commands from any terminal— such as a 
teletypewriter— that is attached to the system. 

ODT-80 (Octal Debugging Technique) is a pro- 
gram written for the MCS-80 that allows the user 
to modify a program via a teletypewriter keyboard. 
The program occupies 400 octal words and must 
be located in the lowest memory page of the 
MCS-80 system, since the program uses the 
RESTART instructions. 

ODT has been proved to be an effective aid 
to debugging on microprocessors. The first 
version, 1 for the Intel 8080,* has been "front 
panel" for virtually hundreds of microprocessor 
applications. The author submits this ODT for the 
8080 in hopes that the tradition of soft panels 
may be perpetuated. 

SYSTEM REQUIREMENTS 

All addresses of memory locations and con- 
tents of memory locations are referred to in 
octal numbers. A question mark (?) will be typed 
for any illegal input. 

The minimum system requirements for using 
ODT are as follows: 

• MCS-80 computer set 

• ODT programmable read only memory (PROM) 
at memory page 000 8 

• 256 word (RAM) at page 01 8 

• Teletype interface with the following codes: 

OUT 2— SEND ASCII character 
IN 2— Input word from TTY 

£r Dj 

IN 3— Read Flags 11 1li"TT ' 
Sending Done. 



J 



Word Received. 



(flag word) 



UTILITY ROUTINES 

The following subroutines are available to 
the user as utility routines for other programs: 



Address 



Call 



Routine 



307 RSTODT Restart ODT program. This 

is useful for error branch- 
ing in program debugging. 

367 RST SEND Send the ASCII character 
presently in the "A" re- 
gister. 

315 CALREAD Wait for a character to be 
received from the tele- 
type and return with the 
ASCII character in the "A" 
register. The "A" and "B" 

333 registers are used in this 

routine. 

315 CALLCRLF Send a carriage return and 
370 a line feed to the tele- 

typewriter. 
The "A" register is used 

in this routine. 

315 CAL OCTALP Send a space and type in 
301 Octal the three digit num- 

ber in the "A" register. 


The A, B, and E registers 
are used in this routine. 

COMMANDS 

(n 8 /) —The ASCII Slash (/) character is used to 

Open the n 8 address and type the contents 

in octal. 

(LF) —The ASCII Line Feed (LF) character is used 
to close the currently open address, and 
open the next sequential address. The 
contents of the open register may be 
changed by typing the octal number to be 
input and then typing a (CR). 

(.) —The ASCII Period (.) operator character may 
be used before the (/) operator to open 
the address last used. 

(n 8 S) —The SET command is used to set the H 
register to the memory page to be accessed. 
(EX) 10S ;H = 010 8 

(n 8 R) —The READ operator is used to start a loader 
program in memory page No. 2, location 0. 
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If this command is preceded by an "nS" 
command, the n value will be passed to the 
loader program in the H register. 

(n„G)— The GO routine is used to start a program 
in memory. The octal number typed before 
the "G" operator will set the starting address 
in memory. The "G" operator should be 
preceded by an "nS" command to select 
the desired page. 

(CTRL- 

C) —The ASCII Control C character is used to 
command the type out of the top two 
locations in the stack. (See trap.) Leaves 
the stack pointer at its initial position -2. 

(CR) —The ASCII Carriage Return (CR) character 
is used to close the currently open address. 



TRAP 

The trap feature of ODT works as follows: 
When the central processor encounters a 377 8 
as an instruction, the processor decodes this as 
a restart to location 70 8 in memory 8 . An example 
of this is when a nonexistent memory is addressed, 
or when a 377 8 is placed in a program for a 
break point. At this time, ODT stores in the 
pushdown stack the address of the errant location 
and all of the registers. The trap indication is a 
"T" typed out on the teletypewriter. Control is now 
back in ODT and multiple Control-C's (CTRL-C) 
typed by the operator will yield, in sets of two 
(One set for each CTRL-C Typed), the trapped 
information in the following format: 



ADDRESS 
ERROR +1 



REGISTERS 



PAGE 

NO. LOCATION A F B CDEHL 

XXX XXX »XXX XXX t »XXX XXX t XXX XXX XXX XXX 

» • 

The "F" register is the status flags of the 8080, with the format 

shown in Fig. 1. 



D r 


D 

6 


D 

S 


D 

4 


D 

3 


D 

2 


D , 


D 




MSB 

(SIGN) 


ZERO 
FLAG 





CARRY 
1 





EVEN 
PARITY 


1 


CARRY 
2 



Fig. 1 . "F" register format. 



A CTRL-C typed at any time will type out 
the pushdown stack but not in the format shown 
above! The above format is only available im- 
mediately after a "T" has been sent by ODT. 

If a continuous string of "T" are sent to the 
TTY without stopping, this is an indication that 
the, stack pointer is pointing at nonexistent memory. 
It will be necessary to restart ODT. 
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RESTART/INTERRUPt LOCATIONS 

There are five segments of memory reserved 
in ODT for INTERRUPT or RESTART operation. 
These locations, shown in Fig. 2, contain jumps 
to the scratch RAM memory #10, used by ODT. 
This allows interrupt service to be handled even 
though memory #0 is preprogrammed to contain 
ODT. 




10 

20 
30 

40 
50 
60 
70 



MEM 



MEM 
*\0 



ODT 
ENTRY 



JMP 
10 



JMP 
10 



JMP 

10 



JMP 

10 



JMP 
50 
10 



SEND 
ENTRY 



TRAP 
ENTRY 



10 



20 



30 



— 50 



STACK! 
POINTER! 



350p 



INTERRUPT 

SERVICE 

ROUTINES 



Figure 2. RESTART/INTERRUPT locations. 

STACK POINTER 

The stack pointer is reset to location 350 8 
every time ODT is restarted via location of 
ROM 0— in other Words, whenever a "?" is sent 
by ODT. ODT and other programs use the stack 
pointer; therefore, memory locations plus and minus 
this location are apt to be overwritten. However, 
the stack pointer moves down in memory (high 
addresses to low addresses), so normal operation 
will keep the stack pointer in RAM 10 8 . 

EXAMPLE OF TYPICAL DEBUGGING 
OPERATION 

The following example illustrates a typical 
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debugging operation. It is assumed that a program 
has been assembled and that the program is to be 
loaded by a loader in PROM 2. 

1. Set the memory field with the S command, and 
read the tape with the R command. 

10S* ;SET MEMORY FIELD TO 10 

0R ;START READER ON TTY 

? ;WHEN TAPE IS READ IN ODT 

RESTARTS (startup of ODT de- 
pends upon the reader program 
in PROM 2) 

2. Start the program with the G command. 

10S ;START PROGRAM AT LOCATION 



0G 

TEST PROGRAM; TYPED BY PROGRAM WITH AN 
ERROR 

3. Change location (30) to correct output. Restart 
ODT. 

? 

10S 

30/327 322) ;CHANGE "W" TO AN "R" 

0G 

TEST PROGRAM ; CORRECTED OUTPUT 



EXAMPLE PROGRAM LISTING 



80B0 MACRO ASSEMBLER, VER 1.1 ERRORS • PAGE 1 













;0DT TEST PROGRAM 














: 10-21-74 




000006 








SEND EQU 6 




000370 








CRLF 


EQU 370Q 

•PROGRAM PROPER 




004000 










ORG 4000Q 




004000 


041 


022 


010 




LXI H TABLE 


;SET UP ADDRESS 


004003 


176 






LOOP: 


MOV A,M 


;GET ENTRY 


004004 


376 


000 






CPI 




004006 


312 


016 


010 




JZ ND 


;IF END OF LIST 


004011 


367 








RST SEND 


;TYPE CHARACTER 


004012 


043 








INX H 




004013 


303 


003 


010 




JMP LOOP 


;LOOP 


004016 


315 


370 


000 ND: 


CALL CRLF 


;SEND CRLF 


004021 


166 








HLT 




004022 


324 






TABLE 


DB 324Q 


;T 


004023 


305 








DB 305Q 


;E 


004024 


323 








DB 323Q 


;S 


004025 


324 








DB 324Q. 


;T 


004026 


340 








DB 240Q 


; SPACE 


004027 


240 








DB 320Q 


;P 


004030 


327 








DB 32 7Q 


;N FOR ERROR 


004031 


317 








DB 31 7Q 


;0 


004032 


307 








DB 307Q 


;G 


004033 


322 








DB 322Q 


;R 


004034 


301 








DB 301Q 


;A 


004035 


315 








DB 31 SQ 


;M 


O04036 


P 








DB 

END 




NO PROGRAM ERRORS 











8060 MACRO ASSEMBLER, VER 1.1 ERRORS = PAGE 2 
SYMBOL TABLE 
• 01 



A 000007 

D 000002 

LOOP 004003 

SEND 000006 



000000 C 000001 

000003 H 000004 

000006 ND 004015 

000006 TABLE 004021 



CRLF 000370 
L 000005 
PSW 000006 



English, who coauthored with me the ODT for 
the 8008, from which a large part of this program 
was derived, and Walt Binge and Mike Maples, 
who helped on the preparation of this paper. 

ODT-80 PROGRAM LISTING 
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80B0 MACRO ASSEMBLER 


VER 1 


1 ERRORS - PAGE J 








:ODT PROGRAM FOR THE MCS-SO 








; 4 -20- 74 


oooooa 




ORG a 




000002 


TTV EQU 5 




000006 


SNO ECU 6 




000003 


FLAG 


ECU 3 




OOOOOO 061 350 01 


3 ERROR 


LXI SP.4350Q 


;SET STACK POINTER. PACE 10. LOC 350 


000003 076 277 




MVI A.277Q 


;S£ND A ? 


000005 303 077 000 


JMP ERR 




000010 303 010 010 


JMP 40IOQ 


:F1RST RESTART LOCATION 


000013 000 




NOP 




0000 It 000 




NOP 




000015 000 




NOP 




000016 000 




NOP 




000017 000 




NOP 




000080 303 020 010 


JMP 40200 




000023 000 




NOP 




000021 000 




MOP 




000055 000 




NOP 




000026 000 




NOP 




000027 000 




NOP 




000030 303 030 OtC 




JMP 4 0300 




000033 000 




NOP 




000034 000 




NOP 




000035 000 




NOP 




000036 000 




NOP,, 




000037 000 




NOP' 




000040 303 040 OtO 




JMP 40400. 




000043 000 




NOP 




000044 000 




NOP 




000045 000 




NOP 




000046 000 




NOP 




000047 000 




NOP 




000050 303 050 010 




JMP 4050Q 




000053 000 




NOP 




000054 1 15 


PER: 


MOV C.L 


;ROUTIN£ TO MAKE PERIOO CURRENT LOCATION 


000055 303 107 000 




JMP NEXTC 




000060 303 344 000 


SENO: 


JMP SEN 


;ENTRY POINT TO SENO ROUTINE 


000063 315 370 000 


GO: 


CALL CRLF 


;SENO A CRLF 


000066 151 




MOV L.C 


;SET THE L REG 


000067 351 




PCHL ;JHP 


TO STARTING ADDRESS 


000070 343 


TRAP: 


XTHL 


jCHANCE ORDER OF STACK H AND L LAST OUT 


00007 1 325 




PUSH 


; FORTH OUT 


000072 305 




PUSH 


: THIRD OUT 


000073 365 




PUSH PSW 


:SECONO OUT 


000074 345 




PUSH H 


;F!RST OU1 IS THE AOR WHENCE WE CAME 


000075 076 324 




MVI A. 3240 ;SEND A T 






THE STACK MAY BE 


DUMPED BY HITTING A CTRL-C TO GET THE FOLLOWING 






; SP*I SP A F B C 


E H L 


000077 367 


ERR: 


RST SNO 




O0CI0O 315 370 000 




CALL CRLF 




000103 257 


BEGIN 


XRA A 


; CLEAR THE AC 


000104 026 004 


BEG: 


MVI 0.4 




000106 117 


SAV: 


MOV C.A 




000107 315 333 000 


NEXTC 


CALL READ 




000112 170 




MOV A. 9 




0001 13 326 270 




SUI 2700 


: IS IT A NUMBER 


0001 15 362 224 000 




JP TERM 


;270 MUST BE TERMINATOR OR ILLEGAL DIGIT 


000120 170 




MOV A.B 




000121 326 2S0 




SUI £600 




000123 372 224 000 




JM TERM 


;YES 


000125 025 




OCR 


;)260 MUST BE DIGIT BUMP BUFFER CNT 


000127 312 0C0 000 




JZ ERROR 


iBUFFER OVERFLOW 


000132 107 




MOV B.A 




000133 17] 




MOV A,C 


:GET PREVIOUS INPUTS 


000 13H 027 




RAL 




000135 027 




RAL 




000136 037 




RAL 




000137 332 000 000 




JC ERROR 


;1F CARRY NUMBER HAS TOO BIG 


00014? 200 




ADO B 




000143 303 106 000 




JMP SAV 




000146 151 


SLASH: 


MOV L.C 


;C CONTAINS ADDRESS 


000147 |76 


GETCON 


: MOV A.M 


:GET CONTENTS 


000150 315 301 000 




CALL OCTALP 




Q00153 076 240 




MVI A.avoo 




000155 367 




RST SNO 




000156 303 103 000 




JMP BEGIN 




000161 172 


LF: 


MOV A.O 




000162 326 004 




SUI 4 




000164 312 170 000 




JZ NINP 


jIF CNT STILL 4 NO INPUT WAS RECEIVEO 


000167 161 




MOV M.C 


ilF CNT <4 DEPOSIT ONPUT IN MEMORY 


D00170 076 215 


NINP; 


MVI A. 215Q 




000172 367 




RST SND 




000173 054 




INR L 


;BUMP ADDRESS 


000174 174 




MOV A.H 


iGET HI PART 


000175 315 301 000 




CALL OCTALP 


;TYPE HI AOORESS 


000200 175 




MOV A,L 


iGET LOW PART 


000201 315 301 000 




CALL OCTALP 


;TYPE LOW ORDER ADOBE SS 


000204 303 147 000 




JMP GETCON 




000207 315 370 000 


CR: 


CALL CRLF 


iSEND A CRLF 


000212 172 




MOV A.O 




000213 326 004 




SUI 4 


• ;BUFCNT -4 1 


000215 312 103 000 




JZ BEGIN 


;YES NO INPUT SINCE LAST TERMINATOR 


000220 161 




MOV M.C 


:LOAD MEMORY WITH INPUT 


000221 303 103 000 




JMP BEGIN 


;ERF 


000224 170 


TERM: 


MOV A.B 




000225 376 212 




CPI 2120 


;IS IT A LF 


000227 312 161 000 




J2 LF 




000232 376 215 




CPI 2150 


:IS IT RETURN 


000234 312 207 000 




JZ CR 




000237 376 322 




CPI 3220 


;R 


000241 312 000 002 




JZ 10000 


iSTART READER PROGRAM 


000244 376 257 




CPI 2570 




000246 312 146 000 




JZ SLASH 




000251 376 307 




CPI 3070 




000253 313 063 000 




JZ CO 


;6 


000256 376 256 




CPI 2560 


: PER 1 00 


000260 312 054 000 




JZ PER 




000263 376 203 




CPI 203Q 




000365 312 357 000 


1 


iJZ CTRLC 


: CONTROL C 


000270 376 323 


CPI 3230 


■s 


000272 302 000 000 




JN2 ERROR 


; FOUND AN ERROR 


000275 141 SETX:" * 


MOV H.C 


jSAME HI ADDRESS 


000276 303 ICO 000 




JMP ERR*I 




000301 006 004 OCTALP: 


MVI B.H 


[SET CNTR 


000303 007 




RLC 
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Your Mail Order Computer Shop... 

IMSAI 8080 kit w<fn22s/ofs(limitedquantity) $599.00 

TDL Z-80 ZPU (the one with full software available now) 242.00 

EdgeConnectorsandguidesforlMSAI each 4.25 

EdgeConnectorsandguidesforlMSAHOfor 40.00 

Seals8kRAMkitwith500nschips 225 -™ 

Seals 8k RAM kit with 250 ns chips 22"22 

NorthStarcompleteMicro-DiskSystemkit ,599.00 



WETAKE 

MASTER CHARGEOR BANKAMERICARD 

For phone and mail orders... 

(Add 4 % of TOTAL ORDER for service charge) 



TERMS: Shipping charges — $10. per CPU or large units, $1.50 per kit, 

$2. minimum per order. 
Provided stock is available, we will ship immediately for payment by 
cashiers check or money order. 

Allow 3 weeks for personal checks to clear. New York State residents 
add appropriate sales tax. 

PRICESSUBJECTTOCHANGEWITHOUTNOTICE. 

For the best prices available on: 

IMSAI • TDL • NORTHSTAR • POLYMORPHIC 
NATIONAL MULTIPLEX • SEALSELECTRONICS 

CALL: (315)637-6208 

WRITE: P.O. Box 71 • Fayetteville, N.Y. 13066 



CIRCLE INQUIRY NO. 77 



TAKE ADVANTAGE OF US! 

DONT DUMP YOUR MONEY INTO THE MAILBOX- 
THEN SIT AROUND AND WAIT!! 

DON'T BUY FROM WANDERING MERCHANTS 

WHO WONT BE THERE WHEN YOU NEED THEM!! 

A COMPUTER MART IS A PLACE WHERE THEY CARE 
ABOUT YOU — AND YOUR COMPUTER EQUIPMENT. 

WE SELL THE BEST LINES, AT REASONABLE PRICES. 
THAT'S HOW WE MAKE OUR LIVING. 

WE HELP YOU GET YOUR SYSTEM UP AND RUNNING. 
WE WILL BE HERE TOMORROW 
AND THE NEXT DAY! 

LEASING ARRANGEMENTS NOW AVAILABLE. 

THE COMPUTER MART 

NEW YORK LONG ISLAND 

314 Fifth Avenue, 2072 Front Street 

New York, N.Y. 10001 East Meadow, L.I., 

(212)279-1048 New York,1 1554 

Between 32nd and 31st (516)794-0510 

Two blocks from the Near Hempstead 

Empire State Building Turnpike 

Closed Monday 
IMSAI PROCESSOR TECHNOLOGY, SOUTHWEST 

TECHNICAL PRODUCTS, OSI, SEALS ELECTRONICS, 
DIGITAL GROUP, APPLE COMPUTERS, TARBELL, OLIVER, 
CROMEMCO, TDL, CONTINENTAL SPECIALITIES, VECTOR, 
GBC VIDEO MONITORS, BOOKS, MAGAZINES, CHIPS, 
SOCKETS, CONNECTORS. . . AND ALL THAT GOOD STUFF. 
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000304 
000305 
000306 
000310 
00031 1 
000318 
000314 
000315 
000316 
000330 
000321 
00032? 
000383 
000384 
000385 
000326 
000330 
000333 
0OO33S 
000336 
000341 
000343 
000344 
000346 
000350 
000351 
000358 
000353 
000354 
000357 
000350 
000361 
000364 
000 365 
□00370 
000 378 
000373 
000375 



NO PROGRAM ERRORS 



A 000007 

C 000001 

000002 

ERROR 000000 

H 000004 



346 007 

303 314 000 

333 003 

037 

ZSS 333 000 

333 008 

107 

3S3 008 

333 003 i 

037 

37 

no 



RLC 

MOV £.A 
MVI A. 8400 

RST SNO 
MOV A.E 
ANI 3 
□CR B 
RZ 

ADI 260Q 
RST SNO 
MOV A.E 
RLC 
RLC 
RLC 
KOV E.A 



JNC RE A3 

IN TTY 

MOV B.A 

OUT TTY 

IN FLAG 

RAR 

RAR 

MOV A.B 

RC 

JMP SEN! 

POP H 

MOV A.H 

CALL OCT ALP 

MOV A,L 

JMP GETCON*! 

MVI A, 8150 

RST SND 

MVI A.8I2Q 

JMP SEN 

ENO 



;CET THE AC 
;MASK 
;OECR 
:OON£ 7 
;NO 
;SENO A CHARAACTER 
;OET AC 



iROUTINE TO READ ONE CHAR PROM TTY 



;R0UT[NE TO OUTPUT AN ASCII CHAR 



RESTORE A REG FROM READ 
DONE? 



iSEND A CRLF 
: RETURN VIA SEND 



SYMBOL TABLE 



NEXTC 
PSW 
SEN I 
SNO 
TTY 



000 1 07 

000006 
000346 
000006 

O0D008 



NINP 
READ 

5EHD 



000000 
000807 
000314 

000003 

000005 

000170 

000333 

000060 • 

000006 



CRLF 



000104 - 
000370 
000003 
GETCO 000147 
LF 000161 



OCTAL 
SAV 
SETX 
TERM 



C003QI 
000106 
000875 • 
0008S4 



000103 

000357 
000077 
000063 
000005 
000054 
000344 



Development Software 

• 8080 DISASSEMBLER 

Two Pass; Converts machine language 
code to assembly code. Uncovers ASCII 
tables. Generates up to 12K labels. 
Prints out symbol table. Address offset 
print output. 



Development Software 

$. 8080 DIS-ASSEMBLER 

• Two Pass 

• Converts machine language code to 
assembly code 

• Uncovers ASCII tables 

• Generates up to 12K labels 

• Prints out symbol table 

• Address offset print output 

• Object code in Intel's punched paper 
tape format @ 30.00 + 1 .50 Calif, sales 
tax + 2.00 postage. Manual @ 5.00 + 
.30 Calif, sales tax + 1 .50 postage. 

EPS-1 SOFTWARE DEVELOPMENT 

OPERATING SYSTEM 

Powerful 8080 Assembler-Monitor-Text 

Editor 

$30.00 + 1.80 Calif, sales tax + 1.50 

postage and handling (includes manual). 

DEALER INQUIRIES INVITED 
Call or Write 

Microcomputer Software Depository 

2631 E. Foothill Boulevard 
Pasadena, California 91107 

(213)449-0616 
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